home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / p / portfoli / dfue / xterm2 / xterm2.doc < prev    next >
Encoding:
Text File  |  1996-10-30  |  5.5 KB  |  124 lines
  1. XTerm2.COM - The next generation Terminal with XModem and
  2. Text File Transfer for the Atari/DIP Portfolio.
  3.  
  4. by Jim Straus                            January 17, 1990
  5. (c) 1990 by Jim Straus                    All rights reserved
  6. Certain portions of the code are (c) 1989 by Atari and DIP.
  7. Program in public domain.  Not for sale.
  8.  
  9. No warranty is given or implied for this program.
  10. In no event shall the author of this work be liable for any
  11. direct, indirect, special, incidental, or consequential
  12. damages (including lost profit) whether based on warranty,
  13. contract, tort, or any other legal theory.
  14.  
  15. This program will only work on the Atari/DIP Portfolio
  16. PalmTop computer.  It is a simple terminal program for the
  17. Serial Interface.  It  allows files to be sent or received
  18. using the XModem protocol.  It also allows files to be sent
  19. with no translation and files to be captured.
  20.  
  21. To use the program, select serial port parameters from the
  22. built-in Setup program.  The Initialize! command does not
  23. need to be given as the program will attempt to initialize
  24. the serial port itself.  You may also want to set the External
  25. Display to Tracked (80x25).  Then start the program by typing:
  26.     XTerm2
  27. at the DIP-DOS prompt.  You will see a greeting, and anything
  28. you type is sent out the serial port.  F1 may be used to exit
  29. the program (Note that the Atari key also generates an F1 key
  30. code).  If you can't see what you are typing on the Portfolio
  31. (most probably, when talking to another local computer), use
  32. F0 to enable Echo.  If you need to turn Echo off, use F0 again,
  33. as it is a toggle.
  34.  
  35. During the session, F2 may be used to start receiving a file
  36. using the XModem protocol.  You will be prompted for a file
  37. name, and then the program will wait for the file to be
  38. transferred.  Each block successfully received will cause a
  39. period to be displayed.  When the file is done, "Done" will
  40. be displayed and you will be back in the terminal portion.
  41. While the program is transferring, the F1 key may be used to
  42. abort the transfer.
  43.  
  44. Sending a file is started with the F3 key and proceeds in a
  45. similar fashion.  If the file was not found, you will just see
  46. "Done" displayed.
  47.  
  48. Note that XModem always transfers files in 128 byte blocks,
  49. so files will tend to be rounded up to the nearest 128 byte
  50. length.  When receiving text files, you may also see extra
  51. space on the end, depending on whether or not the sending end
  52. put in a Control-Z terminating character.  XTerm2 does not put
  53. in such characters and just pads with zeros.
  54.  
  55. The XModem time out values in this program have not been
  56. tested with a packet network (such as that used by Compuserve),
  57. but have been adjusted to Compuserve's suggested values.
  58.  
  59. Capturing text is controlled with the SHIFT-F2 key.  The first
  60. time it is pressed, you will be prompted for a file name.  From
  61. then on anything received is also saved in the file.  To stop
  62. capturing, use the SHIFT-F1 key again.  It will tell you it is
  63. "Done".  Text may be captured through XModem transfers and text
  64. sending, but only received text that is displayed will be saved
  65. in the capture file.
  66.  
  67. SHIFT-F3 is used to send a text file.  It prompts for a file
  68. name and the file is sent.  When the file is done, you will
  69. again see "Done".
  70.  
  71. SHIFT-F1 will display the introduction again as help.
  72.  
  73. Also, CTRL-F0 through CTRL-F9 will cause the files "0.XTM"
  74. through "9.XTM" to be sent.  This can be used to easily send
  75. dialing commands, log on sequences and passwords.  It does not
  76. handle complicated log on procedures, but should simplify
  77. your life some.  As an added bonus, since these keys look for
  78. the files in the current directory, you could create different
  79. directories containing different sets of macro keys.  Then a
  80. simple batch file could take you to the correct directory and
  81. start up XTerm2.  As an example, say I had a set of macros for
  82. Compuserve and had these stored in a directory called CIS.
  83. Then a batch file like:
  84.     c:
  85.     cd CIS
  86.     XTerm2
  87. would start up XTerm2 with my CIS macro keys available.
  88.  
  89. As an experimental feature, XTerm2 will also take command line
  90. options.  The three forms are:
  91.     XTerm2 -r filename
  92.     XTerm2 -s filename
  93.     Xterm2 -h
  94. The -r option will enter the XModem receive state, and when it
  95. is done receiving the file, the program will exit.  The -s
  96. option enters the XModem send state.  The -h option will display
  97. a short summary as a help.
  98.  
  99. The reason for putting these in, was to try and come up with
  100. a semi-automatic method to back up the Portfolio through the
  101. serial port.  In my case, to a Macintosh running the Red
  102. Ryder (tm of FreeSoft Inc.) terminal program.  On the Portfolio
  103. I have a BACKUP.BAT file that looks like:
  104.     echo RECX filename.txt>aux
  105.     XTerm2 -s filename.txt
  106. with the above lines repeated for each file to be backed up.
  107. Red Ryder is left in HOST mode, so the above sequence should
  108. automatically send FILENAME.TXT to the Macintosh.  A similar
  109. process is used to restore the files:
  110.     echo SENDX filename.txt>aux
  111.     XTerm2 -r filename.txt
  112.  
  113. The above sequences have not been thoroughly tested.  There
  114. may still be some timing problems in them (I occasionally hang
  115. restoring.  It can be alleviated by stopping the transfer on
  116. the Macintosh and sending two Control-Xs to cancel that file).
  117. This is not considered a final solution, but I thought people
  118. might be interested.  Others might want to try build scripts
  119. to drive other host machine terminal programs too.
  120.  
  121. The length of the file is 2897 bytes (if transfered with XModem
  122. it will be 2944 bytes) and the checksum (as determined by
  123. CHKSUM.COM) is 99F3.
  124. əəəəəəəəə